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liacrQ—ftssembler ATARI XE» Version 4.3, 


Für alle ATARI 8-Bitter *it Mindestens 128 K-Byte RAM 


Hinweise; 


Dieser flacro-Asseabler benötigt mindestens 128 K-Byte RAtt C64 KB Rechnerspei¬ 
cher sowie eine RAttDISK)! Er wurde von «ir entwickelt, um auch größere Ouell- 
texte zu verarbeiten- Andere Assembler können z-B- "konfiguriert" werden 
CATHAS) uffi mehr Ouelltext Cca. 20 KB> bearbeiten zu können, haben dann aber 
keinen Speicher Mehr für den Objectcode ! 

Der Ouelltext kann saxinal ^8 K-Byte "verbraten", und zu® Ausprobieren des 
Objectcodes bleibt imaer noch genügend Platz (Der Bereich von $3000 bis $BBFF 
kann für Objektcode und Daten genutzt werden). Der Editor wandelt bereits bei 
der Eingabe den Ouelltext in ein sog- Tokenforaat ua. Befehle wie z-B "ORG" 
oder "LDA" brauchen nicht aehr beia Asseablieren in einer Tabelle gesucht 
werden, sondern werden sofort an ihrer Codenummer erkannt! 

Zur Geschwindigkeit des Assemblers; Ich habe alles Machbare versucht, ua den 
Assembler so schnell wie möglich zu machen Clogisch)! Aus Gründen, welche ich 
noch erläutern werde, ist der Assembler nicht so schnell wie er eigentlich sein 
könnte. Der Assembler benötigt zum übersetzen eines 48 KB-Ouelltextes 
Causprobiert) ca- 53 Sekunden (über 700 Symbole, mehr als 10 KByte Objectcode)! 
Bei kürzeren Programmen sinkt sogar die relative Assemblierungszeit CHenn 48 KB 
in 48 Sekunden Assembliert werden, dauert es bei 16 KB nicht unbedingt auch 16 
Sekunden). Der Assemblierungsvorgang wird immer in zwei Durchgängen "erledigt" 
CZ-Pass-Assembler)- 

Der Speicher einer 64 KB RAttDisk wird in vier Bereiche von jeweils 16 KB 
aufgeteilt- Diese 16 KByte-Bereiche werden durch Bankswitching in den Speicher 
von $4000 bis $7FFF eingeblendet. Da jeweils nur eine 16 K-Bank eingeblendet 
werden kann Centweder der Editor/Asseabler oder einer von drei 16 
KByte-Quelltexten> ist es nicht möglich, z-B- vom Assembler mit einem "LDA 
CTextPt),Y" auf den Text zuzugreifen Cwie es eigentlich geplant war). Das Lesen 
aus dem Cund Schreiben zum) Ouelltext muß daher durch ein Unterprogramm erledigt 
werden, was relativ viel Zeit kostet. 

Der Hacro-Asseabler müßte eigentlich mit jeder Speichererweiterung Zusammen¬ 
arbeiten C130 XE, AtariMagazin-RAMDisk). Es gibt auch noch die CompyShop- 
RA^Disk, auf welcher der Assembler nicht getestet wurde CIch kenne z. Zt. 
keinen, der diese besitzt). 

Achtung: Das DUP.SYS-ftenü muß bei einer 64 KB-RAttDisk (130 XE) im Bedarfsfall 

von Diskette nachgeladen werden. Der RAWDisk-Zugriff mit DOS-Befehlen wird 
unterbunden. 256 KB-User können die RAKDisk mitbenutzen !!! 

Der Computer lädt beim BOOTen die Datei "RAttDISK-COH" in den Speicher- Ich habe 
dieses Programm so geändert, daß die Fast-Serial-IO-Routine einer SPEEDY-Erwei- 
terung eingeladen wird, welche (nur!) während des BOOT-Vorganges aktiviert ist! 
Sollte der Computer beia Laden abstürzen, müssen Sie ein altes "RAHDISK.COPl" von 
einer anderen Diskette Kopieren. Sie können auch, während RAflDISK-COn geladen 
wird, die SELECT-Taste gedrückt halten. Dies dürfte aber nicht nötig sein, da 
eine SPEEDY-Erweiterung erkannt wird. 

flachen Sie bitte auf jeden Fall von dieser Diskette eine Sicherheitskopie ! 


Speicherbelegung: 


Eigene Prograsne können den Speicher von $3000 bis $BBFF nutzen, in der 
ZeroPage von $A0 bis $FF ! 


Der Asseabler belegt folgende Speicherbereiche Calle Angaben Hexadezinal) : 


0080 - 009F . für Zeiger und Zuischenspeicherung 

IFFO - 2BFF. für S/stea-'Unterprogranne, Adresstabellen usw. 

2C00 ~ 2FFF . als Arbeitsbereich (Puffer, Zwischenspeicher usw.> 


4000 

5000 

SOOO 

7000 


4FFF (RAHDisk) Editor 

5FFF CRAMDisk) Macro-Asseabler 

&FFF (RAMDisk) Verwaltung der Menü-Leiste (FileSelect, Load, Save usw.> 
7FFF (RAMDisk) Monitor 


COOO - CBFF unter ROM weitere Unterprograane, nachträglich Programmierte Extras 
CCOO - CFFF unter ROM Internationaler Zeichensatz (wahlweise benutzbar) 

D800 - FEFF unter ROM Symboltabelle / Resident-List (Resident-List bis dfff> 
FOOO - F3FF unter ROM Puffer für das Inhaltsverzeichnis der File-Select-Box 
F400 - FFFO unter ROM ToolBox-Utilities, kann durch anwachsende Symboltabelle 

zerstört werden, wird dann nachgeladen ! 


Achtung: 


Es sollte vermieden werden, Interruptroutienen in den Bereich von $4000 bis 
$7fff zu legen, da bei einem Programmabbruch (z-B. BRK oder BREAK/SHIFT) die 
Interrupts nicht ausgeschaltet werden, dort jedoch die RAM-Disk eingeschaltet 
wird weil dort u.A. der Monitor liegt. Dann ist ein Zugriff auf den "normalen“ 
Speicher nicht möglich und der Interruptvektor zeigt auf alles Andere als auf 
das eigene Programm! 


Bei einigen ATARI XL's mit selbsgebauter 25S kB-Erweiterung kam es beim Test 
dieses Assemblers zu Fehlfunktionen und Programmabstürzen. Dies lag aber nicht 
an diesem Programm, sondern an Timing-Fehlern in den RAM-Bausteinen der 
Speichererweiterung! So kann es beim benutzen dieses Programmes passieren, da 
irgendwelche Störungen durch Timing-Probleme auftreten, die beim normalen 
Benutzen nicht auftreten oder nicht bemerkt werden (z.B. RAM-Disk Betrieb, 
Puffer bei Kopierprogrammen o.ä.>. Timing-Probleme können bei diesem Assembler 
auftreten, weil sehr häufig zwischen der Speichererweiterung und dem "normalen" 
Speicher hin- und hergeschaltet wird. Bei Störungen ist daher erstmal (durch 
einen Elektroniker) das Timingverhalten der RAM's zu überprüfen, bei mir (und 
einigen Freunden) läuft das Programm nämlich störungsfrei. 


Programmautor: 


Torsten Karwoth 
Hermann-von-Vechelde-Straße 19 

3300 Braunschweig 


Tel.;(0531) - 69 66 89 


Die Version 4.3 enthält keine mir bekannten Fehler mehr. Da ich den Assembler 
selber regelmäßig benutzte, sind mir (fast?) alle Fehlfunktionen aufgefallen. 
Die erste Version (VI.0) wurde irgendwann im Herbst 1989 angefangen (Oh mein 
Gott, was für Fehler...)! So nach und nach wurden dann die Fehler beseitigt und 
die Funktionen ergänzt (Full-Screen-Editor, Menü-Leiste, Macro-Fähigkeit, 
Geschwindigkeitsoptiffiierung und ... und ... und ... ! 






Der Editor des Macro—Assemblers; 


Nach dea laden gelangen Sie in den Editor des Nacro-Asseablers. Un sich ait den 
Besonderheiten des Editors vertraut zu aachen, geben Sie einfach *aal folgendes 
PrografflB ein. Tippen Sie es so ein, wie es hier steht: 


; Deao 

f 

org $3000 

f 

opt n,r,i 

m 

rtclock=$14 

m 

r 

Start Ida vcount 

asl 

tax 

clc 

sta wsync 
ade rtclock 
sta colpf2 
txa 
sec 

sbc rtclock 
sta colbk 
Ida consol 

emp M6 Start gedrueckt ? 

bne Start Nein, zue Prograffiffianfang 

rts Ja, Exit... 

Wie Sie benerken, werden alle eingegebenen Zeilen in ihr “richtiges Foraat“ ge¬ 
bracht, Sie brauchen also nicht auf Großschrift zu achten. De® Editor ist es 
egal, ob Sie “start Ida (ad),y" eingeben oder "START: LDA (Ad),Y" ! Achtung: 
Wenn Sie ein Befehlswort als Syffibol verwenden wollen, nussen Sie den Doppelpunkt 
fflit angeben <"Lda:" oder "Clc:"> ! Alle eingegebenen Zeilen werden auf Fehler 
überprüft- Sollte die eingegebene Zeile fehlerhaft sein, wird ein Piepton sowie 
der Fehler im Klartext ausgegeben <Adressierungsart, Symbol falsch usw.>! 

Wenn Sie das Prograan vollständig eingegeben haben, Asseablieren Sie es ait 
CONTROL/Y- Während der Assemblierung erscheint ia rechten Teil der Statuszeile 
“Asseabling: Pass 1“ bzw- "Pass 2". Allerdings hat es bei diese® kurzen 

PrografflB keinen Sinn, ait einer Uhr die Zeit messen zu wollen! Sie sehen die 
Angabe der Endadresse, Anzahl der Symbole sowie den freien Speicher in der 
Symboltabelle. "OPT N“ im Listing gibt zusätzlich noch alle Syabole bzw- 
Macros aus- Drücken Sie eine Taste, u® in den Editor zurückzukehren. Sollte 
ein Fehler aufgetreten sein, haben Sie vermutlich irgendwas falsch abgetippt. 
Um das Programm zu starten, gehen Sie ait CONTROL/P in den Monitor- geben Sie 
"G START" (oder “GSTART") ein und drücken Sie RETURN- Sie sehen eine sog- 
“Rainbow-Color-Deao", welche die Farben in jeder Rasterzeile ändert. Diese 
Routine "frißt" allerdings die komplette Rechenzeit des XL, da die Hardware 
Cbzw- die CPU) ®it dem Befehl "STA Wsync" zwecks Synchronisation mit der 
Rasterzeile gestoppt wird! Um solch einen Effekt im Interrupt zu programmieren 
(Rasterzeilen- oder Display-List-Interrupt), lesen Sie bitte Fachliteratur zur 
Programmierung des ATARI! Brechen Sie das Programa ab (Mit der START-Taste oder 
ait RESET). Mit "X" springen Sie vom Monitor zurück in den Editor- 



Hinweis 


Die Adressierungsart "Accu“ wird bei einigen 6502-Asseablern auch ait einea "A“ 
gekennzeichnet, also z.B. "ASL A". Bei diesea Hacro-Asseabler braucht kein “A*' 
angegeben zu werden, es reicht "ASL". Uenn Sie “ASL A” statt “ASL“ schreiben, 
wird das "A" als S/abol erkannt! Sollte es das S/abol "A:" geben, wird der 
ASL-Befehl als "ASL Absolut" in den Objektcode eingefügt! Der Editor kann von 
sich aus nicht wissen, ob das "A" ein S/abol ist oder für "Accu" steht <"R0L" 
statt "ROL A" usw.> ! 


Bedienung des Editors; 

Der Cursor wird ait den Cursortasten gesteuert (mit CONTROL). Uenn er an den 
oberen oder unteren Bildschirarand stößt, wird der Ouelltext gescrollt. Hit der 
Tastenkoabination SHIFT-CursorUp/Down kann ua jeweils 1& Zeilen gescrollt 
werden. Der Ouelltext kann wie in einea Full-Screen-Editor editiert werden. 

Sollte eine Zeile versehentlich geändert worden sein oder eine geänderte Zeile 
fehlerhaft sein, kann die ursprüngliche Zeile ait ESCape zurückgeholt werden. 

Einzelne Textzeilen werden ait SHIFT/DELETE gelöscht. Mehrere Zeilen löschen 
Sie besser ait der Block-Kill Funktion. 

Ua Prograaazeilen in den Ouelltext einzufügen, drücken Sie SHIFT/INSERT. Sie 
befinden sich jetzt ia Insert-Wodus und an der Cursorposition wird eine 
Leerzeile ausgegeben. 

Mit "SHIFT/CONTROL/-" koaat aan zua Textanfang und ait "SHIFT/C0NTR0L/=" zua 
Textende. 


Es gibt folgende COHTROL-Befehles 


Y 

Assembler starten 

P 

Sprung in den Monitor 

C 

Block-Start setzen 

T 

Block-Ende setzen 

? 

Zeige Blockstart Csprung zum Blockanfang) 

CLEAR 

Blockiaarkierung löschen 

INSERT 

Fuge Zeichen in Zeile ein 

DELETE 

löscht Zeichen in Zeile 

TAB 

Tabulator setzten 

ESC 

Menu-Ausuahl > siehe File "Menu.Doc" 

SHIFT/- 

Cursor zua Textanfang 

SHIFT/= 

Cursor zu« Textende 


Ouelltext-Ebenen; 

Der Ouelltext wird in drei Bereiche von jeweils 1& K-B/te aufgeteilt. Diese 
Texte werden nacheinander Asseabliert. Zwischen den 3 Ouelltexten wird 
uageschaltet aits 

SHIFT/CONTROL/1 . aktiviert Seite 1 

SHIFT/CONTROL/2 . aktiviert Seite 2 

SHIFT/CONTROL/3 . aktiviert Seite 3 

In der Statuszeile wird die gerade aktuelle Seite angezeigt, der Speicherplatz 
in dieser Seite und eine eventuelle Fehleraeldung. 

Funktionen wie laden, speichern oder Block-Löschen werden über die Menüzeile an¬ 
gewählt. 






Der Assemb1er; 


Der Asseabler wird voa Editor ait CONTROL/Y gestartet und kehrt nach der Über¬ 
setzung des Ouelltextes wieder zua Editor zurück. Sollte ein Fehler aufgetreten 
sein, so wird der Fehler ia Klartext angezeigt. Nach der Asseablierung werden 
die Endadresse, die Anzahl der Syabole sowie der freie Speicherplatz in der 
Syaboltabeile angezeigt. 


Hacro-Fähiokeits 


Es können aaxiaal 7 nuaerische Paraaeter an Hacros übergeben werden. Nacros 
können nicht verschachtelt werden. 

Nacros aüssen vor ihrea ersten Aufruf definiert werden! Soll ein Hacro benutzt 
werden Cbzw. aufgerufen). So aüssen Sie das dea Editor "sagen", indea Sie dea 
Nacro-Naaen einen Punkt voranstellen. Nenn das Kacro also "Test" heißt, so 
aüssen Sie ".Test" eingeben. Sollte ein S/abol vor dea Nacro-Aufruf stehen (z. 
B. "Loop_l: -Test"), so erkennt der Editor den Nacro-Naaen selbstständig (Sie 
brauchen also nur "loop_l test" einzugeben). Wenn Sie ein Befehlswort als 
Nacro-Naaen benutzen, aüssen Sie allerdings iaaer den Punkt ait angeben! 


Definieren von Bacros; 


Haae: NAC (Anzahl der Paraaeter) 

... Asseabler-Ouelltext ... 

END ; Ende der Nacro-definition 


Beispiele für Hacros: 


Poke: NAC 2 

LDA ll?2 ; Lade Accu ait 2. Paraaeter (Wert) 

STA ?1 ; Schreibe Accu zua 1. Paraaeter (Adresse) 
END ; Ende der Nacro-Definition 

DPoke NAC 2 

LDA tt<?2 ; Lade Accu ait Low-Byte voa 2. Paraaeter 
STA ?1 ; Schreibe Accu zur Adresse (1. Paraaeter) 
LDA #>?2 ; Lade Accu ait High-Byte voa 2. Paraaeter 
STA ?1+1 ; ... 

END 


Schleife 

NAC 

; ohne Paraaeter 


LDY 

«0 

nacLoop@: 

DEY 



BNE 

nacLoop@ ; @ ist 


END 



(oder NAC 0) 

der Klaaaeraffe für lokale Syabole! 


Benutzung von Hacros im Quelltext; 


Start: .Poke Colpf2,$b8 

.Dpoke 5&0,Dlist 

•Schleife ; Nacroaufruf ohne Paraaeter 

".Poke Colpf2,$b8" entspricht also "LDA ♦»♦b8 / STA Colpf2". Mit Macroan- 

weisungen können Sie z.B. Speicher sparen da Ouelltext). Auf der 

Systeadiskette befindet sich eine kleine Deao (lOLIB.SRC). Sie zeigt die 
Benutzung von Nacros und soll nur als Beispiel dienen. Allerdings aüssen Macros 
nicht iaaer "Wirtschaftlich" arbeiten. So z.B. wäre es sinnvoller, das OPEN- 
und INPUT-Hacro als Unterroutine zu Prograaaieren, welche (nach Paraaeterüber- 
gabe) ait JSR angesprungen werden kann! Jedes Benutzen des INPUT-Nacros fügt 
den entsprechenden (langen!) Code in den Objektcode ein !!! 



Rechenforael/Ausdruck: 


Alle Rechenfunktionen werden in Wortbreite <16 Bit) vorgenoAAen. Ein Ausdruck 
darf aus «axinal 7 Klannerebenen zur Klärung der Priorität bestehen. Folgende 
Operationen sind möglich Cin Reihenfolge ihrer Priorität): 

“ft" ... Exclusiv-Oder-Verknüpfung 

... logische Und-Merknüpfung 
... logische Oder-Verknüpfung 

... Multiplikation 
”/" ... Division 

... Addition 
... Subtraktion 

“>** und dienen zus selektieren des High- bzw. Low-Bytes eines Wertes und 

können NICHT bei geklaanerten Ausdrücken benutzt werden. 

Beispiel: 

“Test: LDA #>Tabelle+>Offset“ statt "Test: LDA #>(Tabelle+Offset)“ ! 


Konstanten: 

^A ... ASCII-Code von "A" 

10 ... dezimale Konstante 
$f ... hexadezimale Konstante 
%1 ... binäre Konstante 

Negative Konstanten: 

“ly “Test ... 

Asseabler-Directiven: 

- 0R6 AKyAp) 

Festlegen der Anfangsadresse eines Programmes. 

Al = logische Adresse 
Ap = physikalische Adresse 

ORG $4000 assefflbliert das Programm nach Adresse $4000. Dort ist es auch 
lauffähig. 

ORG $4000y$6000 assembliert das Programm nach $6000. Lauffähig ist es aber ab 
Adresse $4000 ! 

- EOUy EPZ oder ”=“ 

Zuweisung einer Konstanten oder eines Rechenergefanisses an ein Symbol. 

Rtclock: EOU $14 

Rtclock: EPZ $14 (Equate Page Zero, gleich EOU (vom ATMAS übernommen))! 

rtclock=$14 wird zu 


Rtclock: 


EOU $14 








- DFB, DFW 

Definieren von Konstanten/Tabellen im Objektcode. 

Bittab: DFB 1,2,4,8,16,32,128 ; Daten in Bytebreite CO-Bit) 

AdressTab: DFW ib800,$bc00,$9430-.. y Daten in Wortbreite C16-Bit) 


- ASC <STZ>Text<STZ> 

<STZ> = String-Trennzeichen C" / \ Z 
“ = Text ift ASCII-Code einfügen 
/ = Inverser ASCII-Code 

\ = ASCII-Code, aber (nur) beia letzten Zeichen Bit 7 gesetzt CEnde-kennung) 
X = Interner Bildschiracode 
$ = Interner inverser Bildschiracode 


ASC %Dies ist ein Z-Zeichen !Z 

Fügt den Text "Dies ist ein %-Zeichen !" im internen Bildschiracode in den 
Objektcode ein. Das 2. String-Trennzeichen wird von hinten nach vorne gesucht, 
daait das Zeichen selber im Parameter Vorkommen kann (der ATMAS macht hier z.B. 
schwierigkeiten). 


- OPT CN,F,R,I) 

Option beim übersetzen des Ouelltextes. 

H = Harnes 
F = Fast 
R = Resident 
I = Include 

Es wird nur das 1. Zeichen erkannt- "OPT Nichts" würde als "OPT Harnes" inter¬ 
pretiert werden. 

Option Harnes: 

Ausgabe einer Symboltabelle mit den Statuswerten (Unused/Macro). 

Option Fast: 

Assemblieren bei ausgeschaltetem Bildschirm ! 

Option Resident: 

Dieser Assembler ermöglicht das Benutzen einer vordefinierten, einzuladenden 
Symboltabelle, der sogenannten Resident-List. Diese wird beim BOOTen des 
Assemblers mit eingeladen, wenn der Schalter "Resident-List" im Preferences-Menü 
(siehe "Die Menüleiste") auf "On" steht! Sollte also diese Option aktiviert 
sein, so wird ein Symbol, welches bei seinem Aufruf noch nicht definiert wurde, 
in dieser 2- Symboltabelle gesucht! Es ist zu beachten, daß der Speicherplatz 
für die Resident-List von der normalen Symboltabelle abgezogen wird! 

Option Include: 

Ein Symbol, welches in der Resident-List gefunden wurde, wird in die normale 
Symboltabelle eingetragen. Das ist notwendig, wenn man z.B. alle benutzten 
Symbole auf dem Drucker ausgeben möchte (vom Monitor aus möglich), da nur die 
normale Symboltabelle ausgegeben wird. Diese Option sollte immer mit angegeben 
werden. Diese Option darf nicht vor der RESIDEHT-Option stehen. 


Sie können die Optionen durch ein Komma getrennt in einer OPT-Anweisung eingeben 
("OPT Fast,R,I") ooder auch einzeln schreiben! 



- HLT 


Der Befehl HLT bewirkt einen Abbruch des Asseablierungsvorganges an dieser 
Stelle in der jeweiligen Seite. Der Asseabliervorgang wird in der nächsten 
Seite fortgesetzt (wenn ■öglichl. Diese Anweisung ist sehr nützlich, wenn «an 
"aal eben” schnell was ausprobieren will und nicht den ganzen Text löschen will 
(oder auch für andere Zwecke). 

Beispiel (Seite 1 ist angewählt): 

; Testprograffls 

ORG $600 
OPT N,R,I 
5 

Start: LDA Random 

STA Hs/nc 
STA Colpf2 
JHP Start 

HLT ; Assemblierung in dieser Seite abbrechen ! 

m 

. Hier steht der alte/restliche Ouelltext ! 


Jetzt kann das Testprograma ausprobiert werden. Wenn es nicht »ehr benötigt 
wird, kann es lait der Funktion "Block löschen” gelöscht werden. Dann noch alle 
HLT'Befehle entfernen! 


Während der Assemblierung kann mit der BREAK-Taste der Übersetzungsvorgang abge¬ 
brochen werden. 



Funktionen in der Menüleiste; 

Die nenuleiste wird voa Editor aus «it der Tastenkosbination CQHTROL/ESCape 
aktiviert. In der obersten Bildschiriazeile erscheint dann anstelle der 
Titelzeile des Asseeblers die ftenüleiste. Diese (lenuleiste enthält 16 
(lenüpunkte, aus denen mit den Cursortasten oder den Pfeiltasten “größer als“ 
bzu. “kleiner als“ einer ausgewählt werden kann. Der gerade ausgeuählte 
ffenupunkt wird invertiert dargestellt. Um die gewählte Funktion zu aktivieren, 
ist die <RETURH> - Taste zu drücken. 


Anaerkunq zur File-Auswahl in der Menüleiste: 

Sollte irgendeine Diskettenoperation angewählt werden (z.B. “ASCII lesen“ oder 
“Text laden“), so erscheint eine Datei-Auswahlbox. In dieser Box wird ein Teil 
des Inhaltsverzeichnises der gerade eingelegten Diskette, die Laufwerknuaeer 
sowie der freie Speicherplatz auf der Diskette angezeigt. 

Zua einladen muß ein File ait den Cursortasten ausgewählt werden und <RETURH> 
gedrückt werden- Der Filename erscheint Jetzt in der unteren Zeile der Box- 
Zuffl laden drücken Sie nochmals <RETURH> oder wählen Sie ein anderes File. Die 
Dateiauswahl kann mit der ESCape-Taste abgebrochen werden. 

Zua abspeichern einer Datei wählen Sie den Namen aus dem Inhaltsverzeichnis wie 
beim laden (zum überschreiben einer bereits existierenden Datei) oder geben Sie 
einen neuen Namen ein. Dann drücken Sie (nochmals) <RETURN>. Sollte eine 
abzuspeichernde Datei bereits auf der Diskette vorhanden sein, so werden Sie 
gefragt, ob Sie die Datei überschreiben wollen. Drücken Sie auf “J“ für “Ja“ 
oder auf eine andere Taste, um den Vorgang abzubrechen. 

Die Laufwerksnummer können Sie mit “SHIFT“ & Zahlentaste wählen, also z.B. 
“SHIFT/8“ für die RAtt-Disk. Es erscheinen nicht immer alle Filenaroen in der 
Dateiauswahlbox. Quelltexte im internen Format haben den Extender “.ASN“, z.B. 
“D8:FASTLOAD.AS«", Ouelltexte im ASCII-Format haben den Extender “.SRC”, z.B. 
“DlzIOLIB.SRC“ ! In den Jeweiligen Boxen erscheinen daher auch normalerweise 
nur Dateien mit der Jeweils passenden Extension. Diese Endung (z.B. “.SRC“) 
wird auch in der Dateiauswahlbox angezeigt, «it der TABulator-Taste kann aber 
zwischen der normalen Endung und dem kompletten Inhaltsverzeichnis gewechselt 
werden. 


Nun aber zu den Funktionen in der «enü-Zeile: 

1. Inhaltsverzeichnis 

2. Ouelltext laden 

3. Ouelltext speichern 

4. ASCII-Text laden 

5. ASCII-Text speichern 

6. Text drucken 

7. Suche nach ... 

8. Sprung zum Disk Operating System (DOS 2.5) 

9- Assembler-Toolbox starten 

10- Preferences / Voreinstellungen 

11- Block merken ("abfotografieren") 

12- Block einfügen (“ankleben“) 

13- Block ausschneiden (löschen und Zwischenspeichern) 

14- Block löschen ("wegradieren") 

15- Ouelltext reparieren / retten (Old-Funktion) 

16. Ouelltext löschen 


1. Inhaltsverzeichnis: 


- ohne Worte - 



2, Quelltext laden: 


Es erscheint die Datei-Auswahlbox. yählen Sie die gewünschte Datei oder brechen 
Sie die Funktion mit ESCape ab. Sollte die einzuladende Datei kein Ouellcode im 
internen Format sein, wird nichts geladen. Es erscheint auch keine 
Fehlermeldung, und ein evtl. im Speicher stehender Text bleibt erhalten! 

Achtung! Es erscheint auch keine Uarnung, falls Sie diesen flenupunkt versehent¬ 
lich anwählen und ein im Speicher stehender Text noch nicht gesichert wurde! 


3. Quelltext speichern: 

Es erscheint eine Datei-Auswahlbox. yählen Sie eine Datei oder geben Sie einen 
Namen über die Tastatur ein- Drücken Sie <RETURN>, der Speichervorgang beginnt. 


4. ASCII-Text laden: 


Dateiauswahl wie bei Punkt 2 COuelltext laden>« Der ASCII-Text wird an der 
Oursorposition in den evtl. vorhandenen Ouelltext eingefugt (entspricht de® 
INSERT-ttodus). Das Laden wird nicht abgebrochen, falls der Speicher nicht 
ausreichen sollte- Dann geht der Rest des Files allerdings verloren (Es wird 
immer bis zum EOF (End Of File) gelesen)! Der Programmtext wird während des 
ladens in das Token-Format (siehe Editor) umgewandelt- Um das Einladen eines 
inkompatiblen Textes ("andere Assembler - andere Schreibweisen“) nicht zu unter¬ 
brechen, werden fehlerhafte Programmzeilen (welche nicht ohne Änderungen (Feh¬ 
ler ?) in das Token-Format überfuhrt werden konnten) als Kommentarzeilen behan¬ 
delt. Beachten Sie bitte die Schreibweise für die High- und LowByte- Auswahl 
(Beim ttacro-Assemfaler "<" für das Low-Byte und ">" für das HighByte^J. Beim 
ATMAS z.B. wird das High-Byte mit einem ":H" (oder ":HI") gekennzeichnet, also 
z-B- "TABELLEsH". Der Wacro-Assembler macht daraus aber "TABELLE ; H", da er 
den Doppelpunkt als Trennsymbol erkennt! 


5- ASCII-Text speicherns 

Dateiauswahl wie bei Punkt 3 (Ouelltext speichern). Hier gibt es allerdings 
zwei verschiedene Möglichkeiten: Oenn mit der Blockmarkierungsfunktion ein 
Textblock markiert wurde, so wird nur der so markierte Bereich abgespeichert. 
Sonst wird der Text ab der Cursorposition (Zeile, in der der Cursor steht) bis 
zum Ende der aktuellen Seite gespeichert. 


E, Text drucken: 


Textmarkierung siehe Punkt 5 (ASCII-Text speichern). Der Text wird auf dem 
Drucker oder ein anderes Gerät geschrieben (wählbar). Der wohl wichtigste 
Unterschied ist, das bei diesem Menüpunkt alle Leerzeichen mit ausgegeben werden 
während bei Punkt 5 der Text im "kurzen" ASCII-Format ausgegeben wird. Vor¬ 
eingestellt als Ausgabegerät ist der Drucker bzw. das im Preferences-Menü ein¬ 
gestellte Gerät- Dieses kann auch ein beliebiger Schnittstellentreiber sein 
(z-B- "R:600,8N1" für eine RS-232-Schnittstelle) oder auch eine Zieldatei auf 

Diskette. Die Voreinstellung kann natürlich auch geändert werden. 

Beispiel für das Ausgabeformat: 

Ausgabe auf Diskette nach Punkt 5 ("__" = Leerzeichen): 

_Syfflbol:LDA_(Pointer),Y ; mit Quelle laden 
_INY ; nächster Wert 

Ausgabe nach Punkt 6 auf ein beliebiges Gerät (formatierte Ausgabe): 

^Symbol:_LDA (Pointer),Y ; mit Quelle laden 

_INY jf nächster Wert 



7, Suchen nach ,,, 


Der Suchbegriff kann eingegeben bzw. geändert werden. Mit drücken von <RETURN> 
wird ab der Cursorposition gesucht. Bei erfolglose« Suchvorgang steht der 
Cursor am Textende, ansonsten wird die Zeile, in der eine Übereinstimmung 
stattfindet, invertiert dargestellt. Hun kann der Suchmodus mit ESCape 
verlassen oder mit RETURN fortgesetzt werden. Sie können jetzt auch den 
Suchbegriff ändern und weitersuchen, ohne den Suchmodus verlassen und wieder 
aufrufen zu müssen. Zum schnellen löschen (zwecks Neueingabe> des Suchwortes 
können Sie CDNTROL/DELETE eingeben! Während der Suche kann man mit der 
BREAK-Taste den Suchvorgang abbrechen. 


8. Sprung zum Pisk-OperatinQ-System (DOS 2.5): 

Das DOS-ttenü wird in den Computer geladen und gestartet. Das DUP.SYS-ttenü habe 
ich speziell für diesen Assembler geändert (Rücksprung zum Assembler durch 
einfachen Tastendruck). Kopieren Sie das mitgelieferte DOS 2.5 nicht auf 
anderen Disketten (Kein Rücksprung zum Nodul bzw. BASIC) ! 


9. Assembler-Toolbox starten; 


Bei diesem Assembler ist es möglich, eigene Programme oder Erweiterungen bequem 
vom Editor aus aufzurufen (z.B ein Packer o.ä.) ! Ein Beispiel- Sourcefile 
finden Sie im File "TOOLBOX.ASM" auf der Assembler-Diskette. Dieses Programm 
muß so assembliert werden, daß es ab Adresse $f^00 lauffähig ist. Am besten. 
Sie benutzen das Beispielprogramm und ergänzen das ttenü und die Tastaturabfrage- 
Das so erzeugte Programm muß mit dem Write-Befehl des Monitors (nicht mit der 
Save-Funktion) unter dem Namen "TOOLBOX.UTL" abgespeichert werden. Dieses File 
wird beim Booten des Assemblers mit in den Speicher geladen und steht dort 
solange, bis es durch eine anwachsende Symboltabelle überschrieben wird oder bei 
Aufruf der Toolbox mit drücken von <RETURN> die <SHIFT> - Taste gedrückt wird. 
Dann wird versucht, die Toolbox nachzuladen ! 

In der Toolbox des Assemblers V4.3 (Toolbox-Version 1-1) habe ich zwei Tools 
programmiert- Es können damit alle Bemerkungen aus dem Quelltext entfernt 
werden bzw- die Parameter optimiert werden. 


Beispiel zur Parameter-Optimierung: 

Tabelle: DFB %001001,$09,$Of,0123,Test+(%01!%010) 

Start: LDA »fOf 

wird zu 

Tabelle: DFB Xlö01,9,$f,123,Test+(l!%10) 

Start: LDA »$f 


10, Preferences / Voreinstellungen; 

Hier können Sie folgende Einstellungen vornehmen: 

1 - Printer-Device (Default-Gerät bei Anwählen des Drucker-Symbols). 

2 - Farben einstellen (mit ”>”, "+" und ”-"). 

3 - Den Zeichensatz wählen, der nach dem Booten eingeschaltet sein soll. 

4 - Den Directory-sort-Index wählen- 

5 - Das INVERSE-Menü-Flag setzen- 

6 - Den lO-Sound An- oder Abschalten. 

7 - Die Resident-List An- oder Abschalten. 

Die geänderten Einstellungen können mit "Save Prefs" abgespeichert, mit "Quit 
Prefs" nur benutzt oder mit "Load Prefs” die Preferences-Datei geladen werden- 



1 - Printer-Device 


Wenn Sie keinen Drucker haben, den Sie über den Gerätetreiber "P:" ansprechen 
können, aber z.B. ein “RS-232"-Treiber haben, so können Sie diesen vo® Monitor 
aus einladen und initialisieren. Tragen Sie dann hier die Gerätetreiber¬ 
bezeichnung ein < 2 -B- "R:300,8N1”)- 


2 - Farben einstellen: 


Stellen Sie hier die Farben ein, welche der Assenbler haben soll. 


3 - Zeichensatz wählen: 


Die S/ffiboltabelle uberschreibt schon bei sehr kurzen Programmen den originalen 
Zeichensatz tim RAM). Damit es bei der Assemblierung oder bei sonstigen 
Zugriffen auf die Symboltabelle nicht zu einem unschönen Flackern kommt, weil 
die Daten aus der Symboltabelle als Zeichensatzdaten interpretiert werden, kann 
hier der Zeichensatz mit den deutschen Ümlauten/Sonderzeichen eingeschaltet wer¬ 
den. Da einige aber auch eine Happy-Erweiterung besitzen CFloppyspeeder), deren 
Parallel-Treiber im Sonderzeichensatz-Bereich im ROM liegt, kann man auch den 
Originalzeichensatz CStandart-Font) wählen. 


4 - Pirectory-Sort-IndeM: 

Hier kann man einstellen, ob mit der Sortierung des Directorys beim 1- Zeichen 
CO) oder beim 2- Zeichen CI) begonnen werden soll. Das 1. Zeichen ist z-B. 
der Stern für schreibgeschützte Dateien. Sollte also ”0" gewählt sein, so 
werden die schreibgeschützten Dateien extra unter den "normalen” Eiateien ange¬ 
zeigt. Ein Bindestrich zeigt an, daß das Directory nicht sortiert werden soll. 


5 - Inverse-Menü; 

Abhängig von den gewählten Farben ist es nötig, dieses Flag zu setzen. Dies hat 
nur einen optischen Sinn Causprobieren). Die Auswirkung dieses Flags werden 
allerdings erst beim nächsten Aufruf der Menüleiste sichtbar- 


& - IQ-Sound An-/Abschaltens 

Mit diesem Flag kann das Ladegeräusch aus- oder eingeschaltet werden- Einige 
Speeder berücksichtigen dieses Flag allerdings nicht- 


7 - Resident-List An-/Abschalten; 

Wenn die Resident-List beim Aufruf von Preferences abgeschaltet war und Sie die 
Resident-List hier einschalten, wird sie beim verlassen mit "Ouit Prefs" nach- 
geladen! Zur weiteren Information lesen Sie bitte die Beschreibung des 
Assemblers ! 


Bei den Punkten 3-7 wird die Einstellung mit <SPACE> geändert- In der letzten 
Zeile wird mit <SPACE> zwischen "Load Prefs", "Save Prefs" und "Quit Prefs" 
umgeschaltet. Ein Punkt kann mit <RETURN> oder ESCape übersprungen werden CBei 
Load, Save oder Ouit Prefs führt <RETURN> zur Ausführung der Funktion Cz-B. 
Save Prefs) und dann zu einer Rückkehr in den Editor, während man mit ESCape 
wieder bei Punkt 1 landet). 



Wird ein Block z.B. ausgeschnitten, So wird er, da kein Platz sehr im Rech¬ 
nerspeicher ist, auf Diskette bzw. RAflDisk geschrieben. Bei Atari XE Computern 
oder ATARI 800 XL mit 128 kByte RAM C64 kB RAMDisk) kann die RAMDisk nicht mehr 
vom DOS aus angesprochen werden, da dort Prograrnffiteile und Ouelltexte "liegen", 
während bei XL's mit z.B. 256 kB RAfIDisk auf die RAHDisk (64 kB) vom DOS aus 
zugegriffen werden kann. Sollte der Speicher auf der Diskette (oder RAHDisk) 
nicht mehr ausreichen, wird eine Fehlermeldung (Fehlercode für "Disk Full") 
ausgegeben ! Der Name der Datei ist "DSzCLIP.BLK" oder "DlsCLIP.BLK" ! Sollte 
kein Block markiert sein, so wird (außer bei "Block einfugen") eine ent¬ 
sprechende Fehlermeldung ausgegeben. 

11, Block merken: 

Der markierte Block wird in den Block-Puffer abgespeichert, ohne den Queiltext 
zu verändern. 

12, Block einfugen; 

Ein vorher mit "Block merken" oder "Block ausschneiden" gespeicherter Block wird 
ab der Cursorposition in den Quelltext eingefügt. Sollte die Block-Datei länger 
sein als Speicherplatz zur Verfügung steht, so erscheint eine Fehlermeldung. 

13, Block ausschneiden; 


Der markierte Block wird in den Block-Puffer abgespeichert und danach aus dem 
Ouelltext gelöscht. 

14. Block löschens 

Der markierte Block wird aus dem Quelltext unwiederbringlich gelöscht. Der 
Block-Puffer wird dabei nicht verändert (ein vorher abgespeicherter Block bleibt 
also erhalten). 

15. Quelltext reparieren (gelöschten Quelltext zurückholen); 

Mit diesem Menüpunkt kann ein versehentlich gelöschter Quelltext gerettet 
werden. Der Quelltext wird als doppelt verkettete Liste gespeichert- Jede 

Zeile beginnt daher mit einem $ff-Byte (dem Zeilen-Header), gefolgt von einem 
Link-Byte zur vorherigen Zeile und einem Link-Byte zur nachfolgenden Zeile- 
Danach folgt der (codierte) Programmtext. Sollte zum Beispiel ein Linkbyte 

nicht mehr auf den Zeilen-Header zeigen, kommt es beim Editor zum fehlerhaften 
Bildaufbau, es erscheint Schrott auf dem Bildschirm, der Assembler meldet einen 
logischen Fehler. Sollte dieser Fehler auch nach dem Reparieren des Quelltextes 
noch vorhanden sein, so ist die zeileninterne Codierung (Tokencodes, 

Längenangaben von Parameterblöcken usw,) durcheinander geraten. Dann muß die 
jeweilige Zeile von Hand geändert werden. Dieses Fehlverhalten kann auftreten, 
wenn z.B. ein eigenes Programm abgesturzt sein sollte oder wenn während eines 
Speichertransfers (Eine eingegebene Zeile wird sofort in den Quelltext 
eingefügt) die RESET-Taste gedrückt wird und so der Speichertransfer 
unterbrochen wurde. Dann können einige Linkbytes auf falsche Speicherstellen 
zeigen. 

Sollte ein eigenes Programm mal abstürzen und Teile des Assemblers zerstören 

(das ist möglich!), so sollte sofort ein Kaltstart durchgefuhrt werden. Dazu 
NICHT den Computer ausschalten, sondern die Funktionstasten OPTION, SELECT ursd 
START gedrückt halten (!) und RESET drücken. Der Bildschirm muß jetzt für zwei 
bis drei Sekunden blinken, danach wird ein Kaltstart durchgeführt! Der 
Quelltext wird von dem daraufhin stattfindenden Speichertest ja nicht zer¬ 
stört! Jetzt können Sie den Assembler laden und den Quelltext retten, wenn er 
nicht durch einen schwerwiegenden Absturz zerstört wurde. 

Iß. Quelltext löschen; 


Der Ouelltext wird ohne Sicherheitsabfrage gelöscht- 

Anmerkung zu Punkt 15 und Iß: 

Diese Funktionen wirken jeweils nur auf die angewählte Seite (Quelltaxtebene) 
und müssen gegebenenfalls auf mehrere Seiten angewendet werden! 



Der Monitor (Version 3.3); 


In den flonitor gelangt aan vom Editor aus ait "CONTROL/P" ! 


Speichern und Laden / Inhaltsverzeichnis: 

Der Ronitor hat folgende Befehle zua speichern und laden von Daten: 
Load: L <Filenaee> 

Save: S Von,Bis,<Filename>(,Ladeadresse) 

Read: R <Filenaae>,NachC,Länge) 

Urite: U Von,Bis,<Filenaae> 

Zua Anzeigen des Disketteninhaltes gibt es den Befehl 
1 CDriveHua) oder I <Filenaae>. 


nit "L <Filenaae>" wird ein Binärfile in den Speicher geladen. Dabei werden die 
Jeweils belegten Speicherbereiche angezeigt ait "FROH xxxx TO yyyy", "INIT AT 
xxxx" oder "AUTORUN xxxx". In den letzten beiden Fällen CInit/Autorun) wird auf 
einen Tastendruck gewartet. Hit <RETURN> wird zur INIT bzw. AUTORUN-Adresse 
gesprungen. Nach ordentlicher Rückkehr, oder wenn eine andere Taste gedrückt 
wurde, wird mit dea Laden fortgefahren. 


Hit "S Von,Bis,<Filenaae>C,Ladeadresse)" wird der Speicherbereich von "Von" bis 
"Bis" nach <Filename> als Binärfile abgespeichert. 

Beispiel: 

"S $4000 MSff D:TEST.0BJ" 

"S $4000 $43ff D:TEST.0BJ $8000" 

ln 2. Beispiel wird der Bereich von $4000 bis $43ff so abgespeichert, daß er 
nach $8000 bis $83ff geladen wird. 


Hit "R D:TEST.DAT $4000" werden die Daten aus dea File TEST.DAT gelesen und ab 
Adresse $4000 abgelegt. 

"R D:TEST.DAT $4000 $100" ließt nur $100 Bytes aus dem File TEST.DAT nach $4000 
bis $40ff ! 

"1", "1 1" oder "I D1:K.DAT" Zeigt das Inhaltsverzeichnis der Diskette an. 


Starten von Haschienenproorammen: 

G Adr<,AC,Xi:,Y))) 

"G START 120,,TEST" startet ein Haschienencodeprogramm an der Adresse "START" 
(Symbol) und übergibt im ACCU den Wert 120 und im Y-Register den Uert des Labels 
"TEST". X enthält einen Undefinierten Wert! Das Programm kann auf drei Arten 
beendet werden: Hit einem RTS-Befehl, einem BRK-Befehl oder mit der 
Tastenkombination "SHIFT/BREAK". 

Wird das Programm mit einem “RTS" beendet, so wird eine entsprechende Heldung 
ausgegeben. Bei einem Abbruch mit BRK oder SHIFT/BREAK werden die Register 
sowie die Statuswerte ausgegeben. Hit "C" oder "C Adr" kann man im Programm 
fortfahren CContinue-Funktion). 



n Von,Bis,Nach 
F Von,Bis,nit 


"M $3000,♦4fff,$4000” verschiebt den Speicherbereich von $3000 bis $4fff nach 
$4000 bis $5fff. 

•*F $4000 $7fff $80" Füllt den Speicherbereich von $4000 bis $7fff ait den Uert 

$80. 


Disasseabler: 

D (Starte,Endet,<Filenaffle>))) 

"D CAdrl" gibt 15 Zeilen aus, ua dann auf einen Tastendruck zu warten. Wird "X" 
oder "Escape" gedrückt, wird das Disasseablieren abgebrochen, sonst werden 
weitere 15 Zeilen ausgegeben. 

"D $a800 $abff P:" gibt ein Listing auf dea Drucker aus. Auf Tastendruck hält 
das Listen an, nochmaliger Tastendruck außer "X" und "ESCape" läßt es weiter¬ 
laufen. 


Speicherauszua/Speicherinhalt ändern s 

ait ".CAdr>" werden 13 Zeilen des Speicherbereiches als HEX-Duap und als ASCII 
ausgegeben. Wird <RETURN> ait SHIFT gedrückt, wird anstatt ASCII Bildschiracode 
gelistet. 

Nit ".$8000 1 2 4 8" werden die Werte (nur 8 Bit:> 1,2,4,8 ab Adresse $8000 ab¬ 

gelegt. 


Berechnung und Umrechnung; 

"7START,ENDE-START" zeigt den Wert des Syabols “START” sowie das Ergebnis der 
Rechenoperation "ENDE minus START" an. 


Zurück zua Editor; 


Hit "X" (für Exit) koaat man wieder in den Editor! 


Ausgabe der Symboltabelle; 

"V“ zeigt die komplette Symboltabelle an. 

"V *" zeigt die Symboltabelle "halbwegs" sortiert an (Erst alle Syabole mit A, 
dann ait B,....> ! 

“V abc*" Zeigt die Syabole, welche ait "ABC“ anfangen, sortiert an. 

"V SP:" oder "V SP: »" gibt die Symboltabelle auf dem Drucker aus ! 

Sie können mit "V SD:TEST.LST" die Syaboltabelle in ein File schreiben und 
dieses auch mit der "ASCII Text lesen"-Funktion vom Editor einladen (beachten 
Sie, das im Directory nur *.SRC-Files angezeigt werden und wählen Sie mit TAB 
das "Extended Directory")! 


- Wenn ein Befehl einen numerischen Parameter benötigt, kann selbstver¬ 
ständlich auch ein Symbol angegeben werden. 

- Wenn die Henü-Leiste vom Editor aktiviert wird, wird die Symboltabelle 
gelöscht (nicht die Resident-List)! 



Fehleraeldunqen des Editors 


Adressierunosart 

- Die angegebene Adressierungsart für diesen Befehl ist unbekannt. Sie haben 
entwender die falsche Adressierungsart eingegeben Cz.B. ”LDA (10,Y>’*) oder den 
Paraiaeter vergessen (entspricht Adressierungsart "Accu">f 


Labelende falsch 


- Sie haben den "Klaoaeraffen” ("ö") aitten in eine® Sysbol verwendet. Dieses 
Zeichen darf nur a® Ende eines Symbols stehen und kennzeichnet es als lokales 
Label. Wenn Sie ein Label (Sprungziel) in einem Syabol verwenden, ohne dieses 
als "Local" zu kennzeichnen, erhalten Sie bei® 2- Aufruf des Hacros die Fehler¬ 
meldung "Doppelt benutzt"! Das "0” wird durch eine vierstellige Nufflraer aus¬ 
getauscht, welche bei Jede® Macro-Aufruf u® den Wert "1" erhöht wird ! 


Label fehlerhaft 


Sie haben in einem Sprungziel fehlerhafte Zeichen (z-E. Rechenoperatoren 
usw.) eingegeben. Erlaubt sind nur a-z, A-Z, 0-9, und (und "0"). Sie 
können also auch Namen wie "Test-Prg" oder "Stickel" verwenden. 


Symbol fehlt 


- Sie haben einen Befehl eingegeben (z-B- "EOU 10"), ohne diesem ein benötigtes 
Symbol voranzustellen. Diese Meldung tritt auch auf, wenn Sie nur einen Doppel¬ 
punkt eingeben- Ein Doppelpunkt kennzeichnet das Ende eines Symboles. 


Parameter fehlt 


- Sie haben einen Befehl eingegeben (z.B. "rtclock EOU"), ohne den benötigten 
Parameter (Ausdruck) mit anzugeben. 


Macro: Name fehlt 

Sie haben die Macro-Kennzeichnung (".") oder eine Macro-Definition ("Name: 
MAC") ohne Macro-Namen eingegeben. Sie müssen z-B. "-Name" eingeben (nicht 
etwa "- Name") ! 


Macro: fehlerhaft 


Sie haben ein Macro falsch aufgerufen- Wenn Sie z-B "A *1" eingeben, nimmt 
der Editor das A als Symbol und das "*1" als Macro-Name, da er beides keinem 
Befehl zuordnen kann- Ein Macro-Name muß ait einem der unter "Label fehlerhaft" 
beschriebenen Zeichen beginnen- 


Nur ohne Symbol 


Der eingegebenen Assembler-Directiven (z-B- "ORG") darf kein Symbol vorange¬ 
stellt werden- Einem Label (z-B. "Adress:") wird beim Assemblieren der Wert 
des Adresszählers zugewiesen. Dieser Adresszähler wird z-B- bei "ORG" 
verändert. Der Assembler kann aber nicht wissen, ob er dem Symbol den Wert des 
Adresszählers vor oder nach dessen Änderung zuweisen soll- Auch bei "HLT" darf 
kein Symbol mit angegeben werden- 


Was^n das ??? 


- Der Editor kann mit der Eingabe nichts anfangen- Sie haben absoluten Schrott 
einqeqeben (oder z.B. zwei Doppelpunkte hinter einem Symbol). 



Fehleraeldungen des Asseaiblers; 


Folgende Meldungen erscheinen erst bei« Asseablieren; 


Doppelt benutzt 

- Sie wollen ein Symbol definieren, welches schon existiert. Diese fleldung kann 
auch auftreten, wenn ein Symbol aus der Resident-List CBei eingeschalteter 
Option “Resident" und "Include") benutzen und erst später definieren. Wenn Sie 
eine« Symbol, was in der Resident-List existiert, einen neuen Wert zuweisen wel¬ 
len, müssen Sie das vor der ersten Benutzung erledigen! Das Symbol wird nicht in 
der Resident-List verändert, sondern nur mit dem neuen Wert in die Symboltabelle 
eingetragen! Symbole werden immer zuerst in der Symboltabelle gesucht! 


Symboltab, voll 

- Die Symboltabelle ist mit 10 K-Bytes sehr großzügig bemessen. Entweder Sie 
haben irre lange Namen benutzt oder aber zu viele Hacro-Aufrufe mit Localen 
Symbolen CAus "Locales_Label_@:" wird "Locales_Label_öö01“,“Locales_Label_OOÖ2” 
USW-). Sie müssen in Ihren Macro-Definitionen die Namen der localen Labei 
kürzen! Wenn Sie gar keine flacros benutzt haben (oder keine localen Symbole), 
haben Sie wirklich irre lange Symbole verwendet! Kürzen ist angesagt! 


Symbol zu lang 

Ich bin dafür, das die Namen der Symbole so gewählt werden, das ihr Sinn in 
dem Jeweiligen Programmteil auch erkannt wird Cz.B. "CopyLooplschlimmsten¬ 
falls noch "Cpll:" oder so). Ein Symbol darf «aximal 59 (!) Zeichen lang sein. 
Sie haben wahrscheinlich "Dieses_hier_ist_ffleine_Daten_Kopierschleife_nufflffler_ 
eins:" verwendet! Lange Symbole erhöhen die Übersetzungszeit und den Speicherbe¬ 
darf! 


Symbol unbekannt 

In einem Ausdruck verwenden Sie ein Symbol, welche nirgends definiert wurde- 
überprüfen Sie die beanstandete Zeile auch auf Tippfehler. Vielleicht haben Sie 
das Symbol auch bei seiner Definition falsch geschrieben! 


Ausdruck falsch 


- Der angegebene Ausdruck enthält einen Fehler (Falscher Operator), ist unvoll¬ 
ständig (nicht alle oder zu viele Klammern geschlossen) oder die "ASC"-AnWeisung 
enthält falsche String-Trennzeichen oder einen LeerString (ASC "" oder "TestZ)! 


Logischer Fehler !!! 

Der logisch Aufbau des Ouelltextes (in der bemängelten Zeile) wurde irgendwie 
zerstört. Siehe auch Beschreibung der Menüleiste/Punkt 15 (Ouelltext reparier¬ 
en). Diese Weldung kann auch bei Timing-Problemen der RAMDisk auftreten- Dann 
besteht allerding höchste (Absturz-) Gefahr !!! Versuchen Sie die Zeile neu 
einzugeben oder zu editieren! Dieser Fehler darf normalerweise nicht Vorkommen! 


Bisher kein ORG 


- Sie müssen mit ORG die Adressenlage des zu erzeugenden Qfajectcode bestimmen, 
bevor Sie Daten/Befehle in den Speicher schreiben wollen !!! 



- In zweiten Durchgang CPass 2) wurde ein anderer QpCode erzeugt als bei® er¬ 
sten. Dieser Fehler tritt auf, wenn Sie eine ZeroPage-Adressierung benutzen, 
das entsprechende Syabol aber erst später definieren- Ist zu« Beispiel bei® 
übersetzen der Zeile ”LDA Adr,X“ das Syabol “Adr” noch Undefiniert, wird 
autofflatisch die Adressierungsart "Absolut-X“ (Adresse in Uortbreite!) genossen! 
Wird das Sysbol "Adr" später sit z-B- "Adr: EQU $e4" definiert (Zero-Page!), 
so erkennt der Assembler im zweiten Durchlauf eine "ZeroPage-X"-Adressierung 
(Adresse in "Bytebreite" (8 Bit)) und meldet diesen Fehler- Da die ZeroPage- 
Adressierung kurzer ist, stimmen ab diesem die restlichen Sprungziele nicht 
sehr! Sie süssen das Symbol vor der ersten Benutzung definieren. Zu einem 
übersichtlichen und guten Programmierstil gehört sowieso, das möglichst alle 
Symbole am Anfang eines Programses definiert werden! 


Abbruch mit BRK 


- Sie haben die Übersetzung mit der BRAK-Taste abgebrochen! 


Ziel zu weit 


- Relative Sprünge (BNE, BPL usw-) können nur um +129/-125 Bytes springen! Sie 
müssen JPIP verwenden- 


Zahl zu gross 

Eine im Ausdruck angegebene Konstante läßt sich nicht als Wort (16 Bit) dar- 
stellen. überprüfen Sie den Ausdruck (Sie können zwar "$0000e47A" angeben, aber 
nicht "00000034") ! 


Adressueberlauf! 

Der Adresszähler hat einen Überlauf. Sie haben eine fehlerhafte ORG-Adresse 
angegeben oder der Objectcode ist zu lang. 


Zu komplex 

- Der Ausdruck ist zu verschachtelt (mehr als 7 geöffnete Klammern) oder enthält 
zu viele Parameter- Sie können maximal 32 numerische Parameter in einer DFB- 
oder DFW-Anweisung haben- Wenn ein Ausdruck berechnet wird, wird er zuerst in 
16-Bit-Werte zerlegt und danach erst ausgerechnet! 


Division durch Q 


- Durch Null kann nicht dividiert werden! 


Placro-Fehler 


Diese Fehlermeldung tritt auf, wenn 

- die Anzahl der beim Nacro-Aufruf übergebenen Parameter nicht mit der in der 
ttacro-Definition festgelegten Anzahl übereinstimmt- 

- die flacro-Parameterfunktion außerhalb einer Hacro-Definition verwendet wird- 

- in einer flacro-Definition auf einen Racro-Parameter zugegriffen wird, der gar- 
nicht übergeben wurde. 

- ein Racro-Name in einem Ausdruck verwendet wird. 

- eine Racro-Definition nicht in der gleichen Textseite geschlossen wird, in der 
sie eingeleitet wurde- 



- versucht wird eine Macro-Definition zu schließen, obwohl keine geöffnet wurde. 

- ein ttacro-Aufruf in einer Wacro-Definition erfolgt- 

“ Befehle wie z-B. ”HLT“ oder "ORG" in Hacro-Definitionen benutzt werden. 

- wenn Sie «ehr als 9939 Macro-Aufrufe in Ihre« Pogramm verwenden. 


Erläuterungen zu« Uaganq mit flacrosz 

Eine ttacro-Definition (-Einleitung) beginnt mit dem Namen und dem Befehl "NAC", 
gefolgt von der Anzahl der zu übergebenden (numerischen) Parameter. Sollen keine 
Parameter ubergeben werden, können Sie auch "Harne: NAC" statt "Harne: NAC 0" ein¬ 
geben. Beendet wird eine Nacro-Definition mit dem Befehl "END". Parameter werden 
immer in 16-Bit-Breite ubergeben- Die Abfrage der Parameter erfolgt mit dem Fra¬ 
gezeichen und der Hummer des Parameters. Beispiel: 

; Poke-Nacro (wie der BASIC-Befehl POKE ADRESSE,WERT) 

r 

Poke: HAC 2 ; 2 Parameter übergeben 

LDA tt?2 ; Accu mit 2. Parameter laden (Wert) 

STA ?1 ; und zum 1. Wert schreiben (Adresse) 

END ; Ende der Hacro-Definition 

r 

ORG $3000 

T 

Start! .Poke ♦bf00+10*10,129 

RTS 

r 

Wenn Sie dieses Programm assembliert haben, können Sie sich das Ergebnis vom No- 
nitor Disassemblieren lassen. Gehen Sie mit CONTROL/P in den Nonitor und geben 
Sie "D START" ein. Es wird "LDA M$81" (129) und "STA ($bf00+10ö) aus- 

gegeben (u.A-) ! Wenn Sie versuchen auf den 3. Parameter (z-B- mit "LDA tt?3") 
zuzugreifen, erhalten Sie die Fehlermeldung "Nacro-Fehler", da nur Zwei zu uber¬ 
geben waren! Sie können mit den Parametern auch rechnen! Beispiel: 

f 

; Wie mit Nacro-Parametern gerechnet wird 
; (Siehe lOLIB.SRC - .Close <Kanal> 

; Altes (Original-) Nacro: 

m 

Close: MAC 1 

LDA fl?l ; Kanal-Nummer 

ASL ; flultiplikation mit 16 (Wert»2»2«2»2) 

ASL 

ASL 

ASL 

TAX ; Indei-i für Kanal 

LDA «Cclse 

STA Iccom,X 

JSR Ciov 

END 

j Kürzere Version: 

Close: MAC 1 

LDX «?HH6 
LDA »Cclse 
STA Iccoffi,X 
JSR Ciov 
END 
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Nachtrag; 


In der Toolbox habe ich eine neue Funktion programmiert. Mit Punkt 3 (Umschal 
ten) kann bei 256 kB-Erweiterungen zwischen zwei verschiedenen Quelltexten un 
geschaltet werden. 


Wenn Sie die ”Resident-List" verändern wollen, vergessen Sie nicht die Zeile 
"Ende: DFB 0" !!! Speichern Sie immer vom Monitor mit dem Write-Kommando 

"W START ENDE D:RESLIST.DAT"! Erzetzen Sie ENDE nicht durch die vom Assembler 
angegebene physikalische Endadresse! "ENDE" bezeichnet das Label !!! 


Der Unterstrich kann nur eingegeben werden, wenn die Zeile editiert wurde. 
"SHIFT/-" scrollt normalerweise um 16 Zeilen. Wenn Sie also aus "Test.Label:" 
z.B. "Test_Label:" machen wollen, müssen Sie ein anderes Zeichen eingeben und 
dieses überschreiben. 


Der Macro-Assembler läuft nur mit dem geänderten DOS 2.5 einwandfrei (andere 
Versionen wurden nicht getestet)! Achtung: Beim Konf1gurationstest (wenn das 
Titelbild beim laden erscheint) werden direkt im DOS.SYS Speicher Inhalte ge¬ 
ändert (Anpassung für "D8:MEM.SAV" bzw. "D8:DUP.SYS") ! Wenn Sie ein anderes 
DOS benutzen, können Daten auf der Diskette unwiederbringlich zerstört werden 
da andere DOS-Versionen allergisch auf diese Änderungen reagieren können (So 
wird beim Booten das DUP.SYS zwar in die RAMDisk kopiert, aber bei nur 64 KB- 
RAMDslk ein Zugriff durch diese nachträglichen Änderungen auf die RAMDisk un¬ 
terbunden ! Sonst würde ein versehentliches Speichern auf die RAMDisk den 
Quelltext oder Assembler zerstören (und mann könnte nicht auf das DUP.SYS zu¬ 
greifen) ! Verwenden Sie das mitgelleferte DOS nicht auf anderen Disketten ! 


Das Programm (und die Anleitung) ist Shareware. Es darf nur kostenlos weiter¬ 
gegeben werden (wie Public Domain). Es wäre Fair, wenn regelmäßige Benutzer 
mir einen kleinen Betrag zukommen lassen würden! Ich bin hier Ausdrücklich 
dagegen, dieses Programm z.B. gegen "eine Kopiergebühr von nur 10,-- DM" oder 
o weiterzugeben !!! Ich finde es echt fies, wenn andere an PD-Programmen kas 
.iieren und der Programmierer leer ausgeht ! Das ist Ja schon schlimmer als 
Raubkopieren ! 


Mitgelieferte Utilities: 


FirstAid 

FirstAid ist in ATARI-BASIC geschrieben. Es rekonstruiert aus einem mit dem 
PowerPacker V2.1 gepacktem Programm die ungepackte Originaldatei. Sollte es 
Vorkommen, das ein Programm gepackt nicht laufen sollte (dürfte es nicht geben), 
so kann man hiermit die Originalversion erstellen. (Falls ein Programm über 
Init gestartet wird und den Entpacker "beschädigt"). 


SpeedFix 

SpeedFix installiert auf XL/XE-Computern die Speedy-High-Speed-SIO-Routine. 
Das OS-ROM wird ins RAM kopiert und die HS-Routine in den 2. 
internationalen Zeichensatz geladen. Anschließend wird die Sprungtabelle 
geändert. 

Es funktioniert nicht mit Programmen, welche das RAM unter dem OS-ROM bele¬ 
gen !!! Absturzgefahr! 

Es kann vom DOS-Menü geladen werden. 

PACKER i . ? 

Mit dem Packer können fast alle Binary-Load-Files in ihrer Länge verkürzt 
werden. Die zu packenden Programme müssen selbststartend sein. Außerdem 
können selbstgeschriebene Programme (z.B. Vorspann, Zeichensatz, Hauptpro- 
graoun usw.) zu einem einzelnen Programm "zusammengelinkt” werden. 

Nach dem laden meldet sich der Packer mit der Kommandozeile. Es gibt die 
Kommandos Dir, Load, Info, Pack, Rest. (Restore), Save, Quit sowie New. 

- Dir 

Inhaltsverzeichnis ausgeben. 


- Load 


Binärfile einladen. Das einzuladende Binärfile kann auch mehrteilig sein. 
Es kann auch eine INIT-Adresse angegeben werden. 


Beispiel: 

Load - Filename(,Init) 


- D:FONT.BIN 

- DiTITEL.COM, 

- D:TITEL.COM,A800 

- ,1F00 


normales einladen 

einladen und Init-Vektor an 1. Adresse erzeugen 

einladen und Init-Vektor auf angegebene Adresse 
erzeugen. 

Init-Vektor erzeugen oder austauschen. 


Sollte ein Init-Vektor schon existieren, wird die Adresse ausgetauscht 
(nur beim letzten Eintrag)! 


- Info 

Es wird die Speicherbelegung aller geladenen Files angezeigt. Von ge¬ 
packten Teilen wird die Originallänge und die gepackte Länge angezeigt. 



Beispiel: 

FROM:SOOO TO:82A4 LEN:02A5 
Init at:8000 

FROM:0400 TO:0477 LEN:0078 

FROM-.IFOO TO:3EAO LEN:2FA1 / 22EB Original / gepackte Länge 
FROM:OOFO TO:OOF6 LEN:0007 
Init at:0400 
Autorun:lFOO 

Zum Schluß wird noch die Gesammtlänge angezeigt (normale Filelänge und 
gepackte Filelänge (mit Entpacker». 


- Pack 

Im Speicher stehende ungepackten Programmteile werden gepackt. 


- Rest. 

- Restore packed Data - 

Im Speicher stehende gepackte Programmteile werden "entpackt". 


- Save 

Abspeichern unter dem angegebenen Namen. 

Beispiel: 

Save - Filename(,Autorun(,Relocator)): 

- D:AUTORUN.SYS,A800 

Das (gepackte) Programm wird unter dem Namen "AUTORUN.SYS" gepeichert 
und ein Autostart-Vektor an die angegebene Adresse (Hier A800) erzeugt. 
Der Entpacker liegt im Kassetten-Buffer (0400-0477) 

- D:SPIEL.COM,lF00,8000 

Das Programm wird gespeichert, ein Autorun-Vektor nach IFOO erzeugt sowie 
der Entpacker nach 8000 relozlert, liegt also beim späteren Einladen des 
Programmes nicht im Kassettenbuffer (Entpacker enthält absolute Sprünge 
und Unterprogrammaufrufe)! 

- D:SPIEL.COM,,0100 

Das Programm wird gespeichert und der Entpacker nach 0100 reloziert (CPU- 
Stack). Ein Autorun-Vektor wird nicht erzeugt, muß also schon im File 
Vorkommen!!! 

Sollte kein Programmteil gepackt sein, so wird auch kein Entpacker mit in 
das File geschrieben (normale Link-Funktion). 


- Quit 

Verlassen des PowerPackers nach Sicherheitsabfrage (ins DOS). 


- New 

Löschen des Speichers für einen neuen Packvorgang. 

Wenn Sie mehrere Programme packen wollen, müssen Sie den Speicher nach 
dem Speichern wieder löschen, sonst "linken" Sie zwei Programme! 


Beispiele: 

Es sollen fertige Programme gepackt werden: 

Evtl. Speicher mit "N"ew löschen! 

"L" drücken 

Load - Filename(,Init) 

"D:SPIEL.OBJ" 

FROM:8000 TO:BFFF LEN:4000 (Programmdaten) 

FROM:02E0 TO:02E1 LEN;0002 (Autorun-Vektor) 



Evtl, mit "I" die Speicberbelegung anzeigen lassen. 


S" drücken 

Save - Filename(,Autorun(,Relocator)) 


DrSPIELP.COM 
Saving ... 

FROM:0400 T0:0477 LEN:0078 
FROM;8000 TO:AC4E LEN:2C4F 
FROM:OOFO TO:OOF6 LEN:0007 
New Vector Jump (Init/Autorun) 
FROM:02E0 TO:02E1 LEN:0002 

File saved! 


(Entpacker wird geschrieben) 
(Gepackte Daten) 

(Informationen für den Entpacker) 
(Starten des Entpackers) 
(Autostart für Programm) 


Wenn man ein eigenes Programm geschrieben hat, ergibt sich das Problem, 
daß es aus mehreren Teilen besteht, z.B. Zeichensatz, Hauptprogramm, Titel¬ 
vorspann, Spritedaten Ctschuldigung, ich meine Player-Missile-Daten...) 
usw. und so fort! 

Diese Dateien möchte man (sollte man möchten...) gerne in einer einzigen 
Programmdatei haben, also z.B. nicht extra den Zeichensatz nachladen. 

Dazu ist es allerdings nötig, das alle Dateien im Binary-Load-Format vor¬ 
liegen ($FFFF - Startadresse - Endadresse - Daten - ...)! Sollten Sie zu¬ 
fällig über den Macro-Assembler XE, V4.3 verfügen, so können Sie den Zei¬ 
chensatz mit der ”R’'ead-Funktion einiesen und mit ''S”ave abspeichern (z.B. 

”R D:ZEICHENS.FNT $3000" und "S $3000 $33FF D:ZEICHENS.BIN Zieladresse") ! 


Angenommen, Sie haben folgende Dateien, welche Sie gerne "linken" wollen: 


TITEL.COM 

ZEICHENS.BIN 

SPRITES.BIN 

DSOUND.BIN 

BALLER.OBJ 


Zeigt ein Titelbild, muß an 1. Adresse gestartet werden 
Zeichensatz-Daten 
"Sprite"-Daten (PM-Daten) 

Sound-daten (digitalisierte Sound-effekte) 

Das eigentliche Spielprogramm 


1. Titel.Com laden: 


"D:TITEL.COM," (Komma nicht vergessen, evtl. Adressangabe) 
Es erscheint die Meldung "from-to-Len" sowie "Init installed!" 

2. Zeichensatz: 

"D:ZEICHENS.BIN" 

Es erscheint die Meldung "from-to-len" (ohne Init-Kram!). 

3. Sprite-Daten: 

"D:SPRITES.BIN" 

4. Sound-Daten: 

"D:DSOÜND.DAT" 


5. Hauptprogramm; 

"D:BALLER.OBJ" 

Wenn es notwendig sein sollte, eventuelle Interrupts in der Titelbild¬ 
routine auszuschalten, bevor das Hauptprogramm gestartet wird, müssen Sie 
noch einen Init-Vektor auf die ausschaltende routine installieren, welche 
in TITEL.COM stehen sollte ! 

",3403" (als Beispiel) 

Jetzt mit "P" Packen (oder auch nicht). 

Jetzt Abspeichern mit "S": 

Save - Filename(,Autorun(,Relocator)): 

D;SPIEL.COM,"Autostartadresse"(,evtl. neue Entpackeradresse) 
z.B."D:BALLER.COM,8000,0100". 

Nicht ohne Autostart abspeichern! 

über schreiben Sie NIEMALS eine Originaldatei !!! 




